ETSITS132 322V5.0.1 



(2002-12) 



Technical Specification 



Universal Mobile Telecommunications System (UMTS); 

Telecommunication management; 
Test management Integration Reference Point (IRP); 

Information service 
(3GPP TS 32.322 version 5.0.1 Release 5) 



3ji^ 




3GPP TS 32.322 version 5.0.1 Release 5 1 ETSI TS 132 322 V5.0.1 (2002-12) 



Reference 



RTS/TSGS-0532322V50 1 
Keywords 



UMTS 



ETSI 

650 Route des Lucioles 
F-06921 Sophia Antipolis Cedex - FRANCE 

Tel. : +33 4 92 94 42 00 Fax: +33 4 93 65 47 1 6 

Siret N ° 348 623 562 0001 7 - NAF 742 C 
Association a but non lucratif enregistree a la 
Sous-Prefecture de Grasse (06) N° 7803/88 



Important notice 



Individual copies of the present document can be downloaded from: 
http://www.etsi.orq 

The present document may be made available in more than one electronic version or in print. In any case of existing or 

perceived difference in contents between such versions, the reference version is the Portable Document Format (PDF). 

In case of dispute, the reference shall be the printing on ETSI printers of the PDF version kept on a specific network drive 

within ETSI Secretariat. 

Users of the present document should be aware that the document may be subject to revision or change of status. 

Information on the current status of this and other ETSI documents is available at 

http://portal.etsi.org/tb/status/status.asp 

If you find errors in the present document, send your comment to: 
editor(a)etsi.orq 

Copyright Notification 

No part may be reproduced except as authorized by written permission. 
The copyright and the foregoing restriction extend to reproduction in all media. 

© European Telecommunications Standards Institute 2002. 
All rights reserved. 

DECT'^", PLUGTESTS™ and UMTS™ are Trade IVlarks of ETSI registered for the benefit of its IVIembers. 
TIPHON^" and the TIPHON logo are Trade Marks currently being registered by ETSI for the benefit of its Members. 
2QppTM |g g jracle Mark of ETSI registered for the benefit of its Members and of the 3GPP Organizational Partners. 



ETSI 



3GPP TS 32.322 version 5.0.1 Release 5 2 ETSI TS 132 322 V5.0.1 (2002-12) 



Intellectual Property Rights 



IPRs essential or potentially essential to the present document may have been declared to ETSI. The information 
pertaining to these essential IPRs, if any, is publicly available for ETSI members and non-members, and can be found 
in ETSI SR 000 314: "Intellectual Property Rights (IPRs); Essential, or potentially Essential, IPRs notified to ETSI in 
respect of ETSI standards", which is available from the ETSI Secretariat. Latest updates are available on the ETSI Web 
server ( http://webapp.etsi.org/IPR/home.asp ). 

All published ETSI deliverables shall include information which directs the reader to the above source of information. 



Foreword 

This Technical Specification (TS) has been produced by ETSI 3rd Generation Partnership Project (3GPP). 

The present document may refer to technical specifications or reports using their 3GPP identities, UMTS identities or 
GSM identities. These should be interpreted as being references to the corresponding ETSI deliverables. 

The cross reference between GSM, UMTS, 3GPP and ETSI identities can be found under 
http ://webapp . etsi .org/ke y/queryform. asp . 



ETSI 



3GPP TS 32.322 version 5.0.1 Release 5 3 ETSI TS 132 322 V5.0.1 (2002-12) 



Contents 



Intellectual Property Rights 2 

Foreword 2 

Foreword 5 

Introduction 5 

1 Scope 6 

2 References 6 

3 Definitions and abbreviations 6 

3.1 Definitions 6 

3.2 Abbreviations 7 

4 System Overview 7 

5 Information Object Classes 8 

5.1 Information Entities imported and local Labels 8 

5.2 Class Diagram 9 

5.2.1 Attributes and Relationships 9 

5.2.2 Inheritance 10 

5.3 Information Object Classes Definition 10 

5.3.1 Information Object Class TestManagementIRP 10 

5.3.1.1 Definition 10 

5.3.1.2 Attributes 10 

5.3.2 Information Object Class TestActionPerformer 10 

5.3.2.1 Definition 10 

5.3.2.2 Attributes 1 

5.3.3 Information Object Class Teste rObject 1 

5.3.3.1 Definition 1 

5.3.3.2 Attributes 1 

5.3.4 Information Object Class ResourceSeljTestTesterObject 1 

5.3.4.1 Definition 1 

5.3.4.2 Attributes 12 

5.3.5 Proxy Class VSETestCategoryTesterObject 12 

5.3.5.1 Definition 12 

5.3.5.2 Attributes 12 

5.3.6 Proxy Class VSEResourceSelJTestTesterObject 12 

5.3.6.1 Definition 12 

5.3.6.2 Attributes 12 

5.3.7 Proxy Class VSETesterObject 12 

5.3.7.1 Definition 12 

5.3.7.2 Attributes 12 

5.3.8 Proxy Class MO/^r 13 

5.3.8.1 Definition 13 

5.3.8.2 Attributes 13 

5.3.9 Information Object Class Testlnvocation 13 

5.3.9.1 Definition 13 

5.3.9.2 Attributes 13 

5.4 Information Relationships Definition 13 

5.4.1 Relationship between TestManagementIRP and TestActionPerformer 13 

5.4.1.1 Definition 13 

5.4.1.2 Roles 13 

5.4.2 Relationship between TestActionPerformer and TesterObject 13 

5.4.2.1 Definition 13 

5.4.2.2 Roles 14 

5.4.3 Relationship between TestActionPerformer and Testlnvocation 14 

5.4.3.1 Definition 14 



£75/ 



3GPP TS 32.322 version 5.0.1 Release 5 4 ETSI TS 132 322 V5.0.1 (2002-12) 

5.4.3.2 Roles 14 

5.4.4 Relationship between TesterObject and Testlnvocation 14 

5.4.4.1 Definition 14 

5.4.4.2 Roles 14 

5.4.5 Relationship between TesterObject and MORT 14 

5.4.5.1 Definition 14 

5.4.5.2 Roles 15 

5.4.6 Relationship between Testlnvocation and MORT 15 

5.4.6.1 Definition 15 

5.4.6.2 Roles 15 

5.5 Information Attributes Definition 15 

5.5.1 Definition and legal Values 15 

6 Interface Definition 17 

6.1 Class diagram representing interfaces 17 

6.2 Generic rules 17 

6.3 Interface testManagementlRPControlOperations 17 

6.3.1 Operation initiateTests (M) 18 

6.3.1.1 Definition 18 

6.3.1.2 Input parameters 18 

6.3.1.3 Output parameters 18 

6.3.1.4 Pre-condition 19 

6.3.1.5 Post-condition 19 

6.3.1.6 Exceptions 19 

6.3.2 Operation terminateTests (M) 19 

6.3.2.1 Definition 19 

6.3.2.2 Input parameters 19 

6.3.2.3 Output parameters 20 

6.3.2.4 Pre-condition 20 

6.3.2.5 Post-condition 20 

6.3.2.6 Exceptions 20 

6.4 Interface TestManagementlRPMonitorOperations 21 

6.4.1 Operation monitorTest (M) 21 

6.4.1.1 Definition 21 

6.4.1.2 Input parameters 21 

6.4.1.3 Output parameters 21 

6.4.1.4 Pre-condition 21 

6.4.1.5 Post-condition 22 

6.4.1.6 Exception 22 

6.5 Interface TestManagementlRPNotifications 22 

6.5.1 Notification notifyTestResults (M) 22 

6.5.1.1 Definition 22 

6.5.1.2 Triggering Events for the Resource Self Test 23 

6.5.1.2.1 From-State 24 

6.5.1.2.2 To-State 24 

Annex A (informative): Change history 25 

History 26 



£75/ 



3GPP TS 32.322 version 5.0.1 Release 5 5 ETSI TS 132 322 V5.0.1 (2002-12) 



Foreword 



rd , 



This Technical Specification (TS) has been produced by the 3 Generation Partnership Project (3GPP). 

The present document is part of the 32.32x-series covering the 3rd Generation Partnership Project; Technical 
Specification Group Services and System Aspects; Telecommunication Management; Test management Integration 
Reference Point (IRP), as identified below: 



32.321 
32.322 

32.323 
32.324 



"Requirements"; 
"Information service"; 

"CORBA solution set"; 
"CMIP solution set". 



The contents of the present document are subject to continuing work within the TSG and may change following formal 
TSG approval. Should the TSG modify the contents of the present document, it will be re-released by the TSG with an 
identifying change of release date and an increase in version number as follows: 

Version x.y.z 

where: 

X the first digit: 

1 presented to TSG for information; 

2 presented to TSG for approval; 

3 or greater indicates TSG approved document under change control. 

y the second digit is incremented for all changes of substance, i.e. technical enhancements, corrections, 
updates, etc. 

z the third digit is incremented when editorial only changes have been incorporated in the document. 



Introduction 

A 3G telecommunication network is composed of a multitude of different network elements (NE). For a successful 
operation of the network the operator must be provided with mechnisms allowing him to manage the network. These 
management activities can be grouped into several areas: configuration management, fault management, performance 
management, accounting management and security mangement. 

A management function assisting in different high level management areas such as fault management and performance 
management is test management. The purpose of testing is to get information about the functionality and performance 
of the 3G managed network subject to the test. 

The present document is part of a set of technical specifications defining the telecommunication management (TM) of 
3G systems. The TM principles are described in 3GPP TS 32.101 [5]. The TM architecture is described in 
3GPP TS 32.102 [6]. The other specifications define the interface (ITf-N) between the managing system (manager), 
which is in general the network manager (NM) and the managed system (agent), which is either an element manager 
(EM) or the managed NE itself The Itf-N is composed of a number of integration reference points (IRPs) defining the 
information in the agent that is visible for the manager, the operations that the manager may perform on this 
information and the notifications that are sent from the agent to the manager. One of these IRPs is the Test Management 
IRP. 

Each IRP is specified by four TS, the requirements part, the information service (IS) part, the CORBA solution set (SS) 
and the CMIP solution set. 
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Scope 



The present document defines the IS part of the Test Management IRP, which describes the semantics of the 
information and the interactions visible across Itf-N in a protocol independent way. The information is specified by 
means of information object classes and the interactions by means of operations and notifications. The present 
document does not specify the syntax (encoding) of the information. 



References 



The following documents contain provisions which, through reference in this text, constitute provisions of the present 
document. 

• References are either specific (identified by date of publication, edition number, version number, etc.) or 
non-specific. 

• For a specific reference, subsequent revisions do not apply. 

• For a non-specific reference, the latest version applies. In the case of a reference to a 3GPP document (including 
a GSM document), a non-specific reference implicitly refers to the latest version of that document in the same 
Release as the present document. 

[1] 3GPP TS 32.302: "Telecommunication Management; Configuration Management; Notification 

Integration Reference Point; Information Service version 1". 

[2] 3GPP TS 32.312: "Telecommunication management; Generic Integration Reference Point (IRP) 

management; Information service". 

[3] 3GPP TS 32.622: "Telecommunication management; Configuration Management (CM); Generic 

network resources Integration Reference Point (IRP): Network Resource Model (NRM)". 

[4] ITU-T Recommendation X.733: "Information technology - Open Systems Interconnection - 

Systems Management: Alarm reporting function". 

[5] ITU-T Recommendation X.745: "Information technology - Open Systems Interconnection - 

Systems Management: Test management function". 

[6] 3GPP TS 32.101: "3G Telecom Management principles and high level requirements". 

[7] 3GPP TS 32.102: "3G Telecom Management Architecture". 

[8] 3GPP TS 32.321: "Telecommunication management; Test management Integration Reference 

Point (IRP); Requirements". 

[9] 3GPP TS.32.672: "Telecommunication management; Configuration Management (CM); State 

Management Integration Reference Point (IRP): Information service". 

[10] ITU-T Recommendation X.737: "Information technology - Open Systems Interconnection - 

Systems Management: Confidence and diagnostic test categories. 



3 Definitions and abbreviations 

3.1 Definitions 

For the purposes of the present document, the terms and definitions given in 3GPP TS 32.101 [6], 3GPP TS 32.102 [7] 
and 3GPP TS 32.321 [8] apply. 
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3.2 



Abbreviations 



For the purposes of the present document, the following abbreviations apply: 

IOC Information Object Class 

IRP Integration Reference Point 

IS Information Service 

ME Element Manager 

MORT Managed Object Referring to Test 

NE Network Element 

TM Telecommunication Management 



System Overview 



Figures 1 and 2 show the system context of the present document in terms of implementations called IRP Agent and 
IRPManager. 

The term IRPManager refers to a process that interacts with IRP Agent for the purpose of test management via this IRP. 
An example of an IRPManager can be a Network Management System. IRP Agent implements and supports the Test 
Management IRP. 

IRP Agent can be one Network Element (NE) (figure 2) or it can be one Element Manager (EM) with one or more NEs 
(figure 1). In the latter case, the interfaces (represented by a thick dotted line) between the EM and the NEs are not 
subject of this IRP. Whether EM and NE share the same hardware system is not relevant to the present document either. 
By observing the interaction across the Test Management IRP, one cannot deduce if EM and NE are integrated in a 
single system or if they run in separate systems. 

As indicated in figures 1 and 2, the subject document need to be complemented with the Notification IRP [1] (to allow 
IRPManager to subscribe to notifications issued by IRP Agent and (optionally) product-specific resource models 
describing the MOs maintained by the IRP Agent). 
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Figure 1 : System Context A 
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Figure 2: System Context B 
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5 Information Object Classes 

5.1 Information Entities imported and local Labels 



Label reference 


Local label 


3GPP TS 32.622 [3], information object class, Top 


Top 


3GPP TS 32.622 [3], information object class, IRPAgent 


IRPAgent 


3GPP TS 32.312 [2], information object class, managedOenericIRP 


managedGenericIRP 
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5.2 Class Diagram 

5.2.1 Attributes and Relationships 

The following figure shows, for the Test Management IRP, the class definitions and the relationships between the 
classes. 



theTesterObject 



«lnformationObjectClass» 
TestManagementlRP 



«lnformationObjectClass» 
TestActionPerformer 

■ supportedTOCIasses 

■ testActionPerformerld 



theTestlnvocation 



\L 



-> 



theTesterObject 

* 

\^ 

«lnformationObjectClass» 
TesterObject 

+ testOutcome 
+ testState 

- testlnvocationlnitiator 

- additionallnformation 

- proposedRepairActions 

- fileReference 

- fileExpiryDate 
+ testerObjectId 



1 

theTestlnvocation 



V 



«lnformationObjectClass» 
Testlnvocation 

■ actualStartTime 

■ actualStopTime 
maxTestingPhaseDuration 

■ testlnvocationid 



isTesting ^ 



1 



^ 

«ProxyClass» 
MORT 



theMORT 



Figure : 

From the cardinalities can be seen that each instance of TestManagementlRP may have several instances of 
TestActionPerformer. Each instance of TestActionPerformer can have multiple instances of associated TesterObjects. 
Each instance of TesterObject in turn has one instance of Testlnvocation and one instance of MORT. 
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5.2.2 Inheritance 

The following figure depicts the inheritance relationships between the information object classes. As can be seen the 
IOC TestManagementIRP inherits from ManagedGenericIRP , the Proxy Class VSEResourceSeljTestTesterObject 
inherits from the IOC ResourceSeljTestTesterObject which in turn inherits from TesterObject. The Proxy Class 
VSETesterObject inherits from the Proxy Class VSETestCategoryTesterObject which inherits from the IOC 
TesterObject. By default lOCs inherit from the IOC Top. 



«lnformationObjectClass» 
ManagedGenericI RP 



X 



«lnformationObjectClasses» 
TesterObject 



«lnformationObjectClass» 
TestManagementI RP 



«lnformationObjectClass» 
ResourceSelfTestTesterObject 



TT 



«ProxyClass» 
VSETestCategoryTesterObject 



T 



«ProxyClass» 
VSEResourceSelflestTesterObject 



«ProxyClass» 
VSETesterObject 



Figure 



5.3 Information Object Classes Definition 
5.3.1 Information Object Class TestManagementIRP 



5.3.1.1 



Definition 



The IOC TestManagementIRP together with the IOC TestActionPerfonner represent the test management capabilities 
defined by this specification. To conduct a test of network resources, this object may require capabilities of other 
objects such as TesterObject. The IOC TestManagementIRP inherits from the IOC ManagedGenericIRP specified in 

3GPPTS 32.312 [2]. 

5.3.1.2 Attributes 

The IOC TestManagementIRP has no own attributes, only those inherited from the IOC ManagedGenericIRP . 

5.3.2 Information Object Class TestActionPerformer 



5.3.2.1 



Definition 



The IOC TestActionPerformer provides the ability to receive and react upon test requests. This class must also be able 
to instantiate and delete tester objects or, in case the tester objects are permanently instantiated, to allocate and reserve 
them for their usage. This specification does not require this IOC to be instantiated. It may be abstract and used for 
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inheritance purposes only. In this way the ability to receive and react upon test requests may be included in any other 
IOC. 



5.3.2.2 



Attributes 



Attribute name 


Visibility 


Support Qualifier 


Read Qualifer 


Write Qualifier 


supportedTOCIasses 


+ 


M 


M 


- 


testActionPerformerld 


+ 


M 
see note 


M 


- 


NOTE: This attribute is only mandatory in case tine IOC TestActionPerformer is instantiated. In case this IOC is an 
abstract class and used for inheritance purposes only the attribute shall be omitted. 



5.3.3 Information Object Class TesterObject 



5.3.3.1 



Definition 



The IOC TesterObject monitors and controls the testing of a MORT instance and reports the outcome of the test 
execution. Tester Objectss (TOs) are instantiated by the IOC TestActionPerformer in response to a valid test initiation 
request (initiateTests). They are deleted after termination of the test. It is also possible that TOs are permanently 
instantiated. In this case they are allocated to a certain TestActionPerformer during the test execution. After termination 
of the test they are released. 

The IOC TesterObject defines a generic TO. It shall be used as an abstract class from which more specific tester objects 
shall be derived by specialisation for each test category. Test categories and the associated test category specific TOs 
are defined in ITU-T Recommendation X.737 [10]. These test category specific TOs can be specialised further by 
defining vendor-specific-extended (VSE) TOs. The generic TO defines attributes pertaining to a test and required for all 
test categories. 

Each test invocation shall have only one associated TO. 

Only test category specific TOs or VSE TOs shall be instantiated. 

For simplicity this specification will often use only the term TO. In this case either the test category specific TO or the 
VSE TO is referred to depending on which is actually instantiated. 



5.3.3.2 



Attributes 



Attribute name 


Visibility 


Support Qualifier 


Read Qualifer 


Write Qualifier 


testOutcome 


+ 


M 


M 


- 


testState 


+ 


M 


M 


- 


testlnvocationlnitiator 


- 


C 


IVI 


- 


additionallnformation 


- 





- 


- 


proposedRepairActions 


- 





- 


- 


fileReference 


- 


M 
see note 


- 


- 


fileExpiryDate 


- 


IVI 
see note 


- 


- 


testerObjectId 


+ 


M 


M 


- 


NOTE: In case the TO does support capturing test results in a file this parameter shall be present and contain 

information. In case the TO does not support capturing test results in a file this parameter shall contain no 
information or shall be absent. 



5.3.4 Information Object Class ResourceSelfTestTesterObject 



5.3.4.1 



Definition 



The IOC ResourceSelfTesterObject is a specialised TO for the resource self test. It inherits from the IOC TesterObject. 
It specifies the triggering events for the emission of the test result notifications. 
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5.3.4.2 Attributes 

This IOC has no own attributes, only those inherited from the generic IOC TesterObject. 

5.3.5 Proxy Class VSETestCategoryTesterObject 

5.3.5.1 Definition 

Certain tests may not fit in any of the test categories defined in ITU-T Recommendation X.737 [10]. In this case 
vendors may define new (VSE) test categories and the associated test category specific TOs. The Proxy Class 
VSETestCategoryTesterObject represents the set of these VSE test category tester objects 

The lOCs represented by the Proxy Class VSETestCategoryTesterObject shall inherit from the IOC TesterObject. 

NOTE: A vendor may also claim 3GPP compliance to a certain release in case that a specific test fits into one of 
the ITU-T test categories without that the corresponding ITU-T test category specific TO is supported in 
this release supposed that this test category specific TO will be added in a later release than the current 
one. The vendor shall update this specification in due time. 

5.3.5.2 Attributes 

The attributes of this IOC are vendor specific. 

5.3.6 Proxy Class VSEResourceSelfTestTesterObject 

5.3.6.1 Definition 

In case the IOC ResourceSelfTestTesterObject does not fulfil the specific requirements of a certain resource self test, 
vendors may define proprietary lOCs by further specialisation. The Proxy Class VSEResourceSelfTestTesterObject 
represents these lOCs. 

The lOCs represented by the Proxy Class VSEResourceSelfTestTesterObject shall inherit from the IOC 
ResourceSelfTestTesterObject. 

5.3.6.2 Attributes 

Apart from the attributes inherited the attributes of the lOCs represented by this Proxy Class are vendor specific. 

5.3.7 Proxy Class VSETesterObject 

5.3.7.1 Definition 

In case an IOC represented by the Proxy Class VSETestCategoryTesterObject does not fulfil the specific requirements 
of a certain test, vendors may define proprietary lOCs by further specialisation. The Proxy Class VSETesterObject 
represents these lOCs. 

The lOCs represented by the Proxy Class VSETesterObject shall inherit from the associated IOC represented by the 
Proxy Class VSETestCategoryTesterObject. 

5.3.7.2 Attributes 

Apart from the attributes inherited the attributes of the lOCs represented by this Proxy Class are vendor specific. 
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5.3.8 Proxy Class MORT 



5.3.8.1 



Definition 



The ProxyClass M(9/?r represents a network resource that is under test. Its class definition shall be one defined in the 
various 3GPP Network Resource Model specifications or defined by a VSE network resource class. 

5.3.8.2 Attributes 

This IOC has no attributes. 

5.3.9 Information Object Class Testlnvocation 



5.3.9.1 



Definition 



The IOC Testlnvocation is the abstract representation of a test invocation. A test invocation shall aim to test one or 
more capabilities of a MORT. The IRPManager can request for the establishment of a test invocation using the 
operation initiateTests. 

A MORT can be complex in that there are multiple capabilities that can be subject to test. Therefore, it is possible to 
have multiple test activities active, all aimed at the same MORT but on its different capabilities. Whether multiple test 
activities can be testing the same MORT capabilities at the same time is an implementation decision, probably based on 
the nature and behaviour of the TO, and therefore, is outside the scope of this specification. 



5.3.9.2 



Attributes 



Attribute name 


Visibility 


Support Qualifier 


Read Qualifer 


Write Qualifier 


actualStartlime 


+ 





M 


- 


actualStopTime 


+ 





M 


- 


maxTestingPhaseDuration 


- 





- 


- 


testlnvocationid 


+ 


M 


M 


- 



5.4 Information Relationships Definition 

5.4.1 Relationship between TestManagementIRP an6 
TestActionPerformer 

5.4.1.1 Definition 

This relationship defines a binary association between the IOC TestManagementIRP and the IOC TestActionPerformer. 

5.4.1.2 Roles 

This relationship has no roles. 

5.4.2 Relationship between TestActionPerformer an6 TesterObject 



5.4.2.1 



Definition 



This relationship defines a binary association between the IOC TestActionPerformer and the IOC TesterObject. The 
association is navigable from the TestActionPerformer to the TesterObject. 
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5.4.2.2 



Roles 



Name 


Definition 


theTesterObject 


This rolename provides a name allowing to navigate from an instance of 
TestActionPerformerto the associated instances of TesterObJect. If tap is an 
instance of TestActionPerformert, the expression tap.theTesterObject Y\e\6s the 
set of object instances of TesterObJect. 



5.4.3 Relationship between TestAction Performer and Testlnvocation 



5.4.3.1 



Definition 



This relationship defines a binary association between the IOC TestActionPerformer and the IOC Testlnvocation. The 
association is navigable from the TesterObJect to the Testlnvocation. 



5.4.3.2 



Roles 



Name 


Definition 


theTestlnvocation 


This rolename provides a name allowing to navigate from an instance of 
TestActionPerformer \o the associated instances of Testlnvocation. If fap is an 
instance of TestActionPerformert, the expression tap.tl-ieTestlnvocationy\e\6s the 
set of object instances of Testlnvocationt. 



5.4.4 Relationship between TesterObJect and Testlnvocation 



5.4.4.1 



Definition 



This relationship defines a binary association between the IOC TesterObJect and the IOC Testlnvocation. The 
association is navigable in both directions. 



5.4.4.2 



Roles 



Name 


Definition 


theTesterObject 


This rolename provides a name allowing to navigate from an instance of 
Testlnvocation to the associated instance of TesterObJect. If f/is an instance of 
Testlnvocation, the expression ti.tl-ieTesterObjecty\e\6s an object instance of 
TesterObJect. 


theTestlnvocation 


This rolename provides a name allowing to navigate from an instance of 
TesterObJect \o the associated instance of Testlnvocation. If to is an instance of 
TesterObJect, the expression to.theTestlnvocation Y\e\ds an object instance of 
Testlnvocation. 



5.4.5 Relationship between TesterObJect and MORT 



5.4.5.1 



Definition 



This relationship defines a binary association between the IOC TesterObJect and the Proxy Class MORT. The 
association is navigable from the TesterObJect to the MORT. 
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5.4.5.2 



Roles 



Name 


Definition 


theMORT 


This rolename provides a name allowing to navigate from an instance of 
TesterObjectto the associated instance of MORT. If to is an instance of 
TesterObject, the expression to.theMORT y\e\6s an object instance of MORT. 



5.4.6 Relationship between Testlnvocation and MORT 



5.4.6.1 



Definition 



This relationship defines an association between the IOC Testlnvocation and the IOC MORT. This association specifies 
that the latter is testing the former. 

5.4.6.2 Roles 

Instead of roles this relationship has a role name. 



5.5 



Information Attributes Definition 



5.5.1 Definition and legal Values 



Attribute Name 


Definition 


Legal Values 


testlnvocationid 


This attribute uniquely identifies an instance of 
a Testlnvocation within the 
TestlVlanagementlRP. The test invocation 
identifier is assigned by the 
TestActionPerformer. When a testlnvocationid 
can be reused is outside the scope of this 
specification. 




testState 


This attribute reflects the actual test state (ITU- 
T Recommendation X.745 [5]). 


ENUIVI {notlnitialized, idle, initializing, 
testing, terminating, disabled} 


testOutcome 


This attribute provides information about the 

test result, as perceived by the associated TO, 

in a standardised manner. 

The infomation in this parameter is only valid 

after termination of the test activity. 

This information shall be present in the last test 

result notification emitted by a TO prior to its 

deletion. 


ENUIVI {pass, fail, inconclusive, timed-out, 
premature-termination} 
Pass indicates that the test exercise of the 
test invocation has executed correctly and 
has found no problem. 
Fail indicates that the test exercise of the 
test invocation has executed correctly and 
has found one or more problems. 
Inconclusive indicates that the TO has not 
determined if the execution is Pass or Fail. 
Timed-out indicates that the TO has 
terminated its execution because of the 
expiry of the timer (i.e., the current time - 
TestSession.sessionStartTime >= 
TesterObject.timeOut). 
Premature termination indicates that the TO 
has (a) never started execution or (b) 
terminated its execution prematurely, either 
by Testl\/lanagementlRP and its associated 
objects internal problems or in response to a 
terminateTests operation. 


supportedTOCIasses 


This attribute identifies the TO classes that are 
supported by a certain managed object 
instance whose class has inherited from 
TestActionPerformer or whose class is the 
TestActionPerformer. 


SET OF TO class name 


testActionPerformerld 


This attribute unambiguously identifies an 
instance of a TestActionPerformer 




testerObjectId 


This attribute unambiguously identifies an 
instance of a TesterObject. 
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Attribute Name 


Definition 


Legal Values 


testlnvocationlnitiator 


It identifies the IRPIVlanager. 


How multiple IRPIVIanagers choose their 
identifier so that they are distinguishable is 
outside the scope of this specification. 


additionallnformation 


This attribute holds a set of additional 
information pertaining to the test. 


The semantics of this parameter are outside 
the scope of this specification 


proposedRepairActions 


This attribute suggests one or more repair 
actions if the reason for a failure is known. 


The semantics of this parameter are outside 
the scope of this specification 


actualStartTime 


This attribute specifies the time at which the TO 
will enter or has entered the test state testing. 
Before the TO enters the testing state this is an 
estimated time. After entering the testing state 
this is the actual time. Note that this is not the 
time of the invocation of the operation 
initiateTests. 


All values indicating a valid time. 


actualStopTime 


This attribute specifies the time at which the TO 
will leave or has left the test state testing. 
Before the TO leaves the testing state this is an 
estimated time. After leaving the testing state 
this is the actual time. Note that this is not the 
time of the invocation of the operation 
terminateTests. 


All values indicating a valid time later than 
the actualStartTime. 


maxTestingPhaseDuration 


This attribute specifies the maximum amount of 
time that a TO may spend in the testing state. 


All values indicating a valid amount of time. 


fileReference 


This attribute carries the reference to a file that 
contains the test result data set. 




fileExpiryDate 


This attribute carries the date and time after 
which the file, whose reference is carried by the 
fileReference attribute, may be removed. 


All values indicating a valid time. 
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6 Interface Definition 

6.1 Class diagram representing interfaces 

The following diagram depicts the interfaces of the Test Management IRP with their corresponding operations and 
notifications. 



«lnterface» 
TestManagementlRPControlOperations 



+ initiateTestsO 
+ terminateTestsO 



<- 



«lnformationObjectClass» 
TestActionPerformer 



«lnterface» 
TestManagementlRPMonitorOperations 



+ monitorlestO 



-<- 



«lnterface» «lnformationObjectClass» 

TestManagementI RPNotif ications TesterObject 



-^ 



+ notifyTestResultsO 

Figure : 

6.2 Generic rules 

Rule 1: each operation with at least one input parameter supports a pre-condition valid_input_parameter which 
indicates that all input parameters shall be valid with regards to their information type. Additionally, each such 
operation supports an exception operation_failed_invalid_input_parameter which is raised when pre-condition 
valid_input_parameter is false. The exception has the same entry and exit state. 

Rule 2: Each operation with at least one optional input parameter supports a set of pre-conditions 
supported_optional_input_parameter_xxx where "xxx" is the name of the optional input parameter and the pre- 
condition indicates that the operation supports the named optional input parameter. Additionally, each such operation 
supports an exception operation_failed_unsupported_optional_input_parameter_xxx which is raised when (a) the pre- 
condition supported_optional_input_parameter_xxx is false and (b) the named optional input parameter is carrying 
information. The exception has the same entry and exit state. 

Rule 3: each operation shall support a generic exception operation_failed_internal_problem that is raised when an 
internal problem occurs and that the operation cannot be completed. The exception has the same entry and exit state. 

6.3 I nte rf ace testManagementlRPControlOperations 

The interface TestManagementlRPControlOperations contains the operations initiateTests and terminateTests. It must 
be implemented by every object with the ability to receive and react upon test requests, for example by every instance 
of TestActionPerformer. 
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6.3.1 Operation initiateTests {M) 



6.3.1.1 



Definition 



The IRPManager uses this operation to request the IRP Agent to initiate controlled tests. A single test request may 
initiate multiple (one or more) tests. 

For each test to be initiated the managed object representing the network resource to be tested and the tester object class 
must be specified. 

The initiated tests are independent and not related to each other. This implies that independent test result notifications 
are sent for each of the tests initiated by s single initiateTests operation. 



6.3.1.2 



Input parameters 



Parameter Name 


Qualifier 


Information Type 


Comment 


testlnvocationlnitiator 


C 


TesterObject. testlnvocationlnitiator 


This parameter identifies the IRPManager.. 


maxTestingStateDuration 





Testlnvocation. maxTestingStateDuration 


This parameter specifies the timeout 
period of the tests to be initiated. A certain 
value shall indicate forever. 


toBelnitiatedTests 


M 


SET OF SET { 

toBeTestedlVIORT (0) 

testerObjectClass (IVI) 

testerObjectlnitialAttributeList (0) 
} 


This sequence specifies the tests to be 
initiated. 

For each test the parameter 
fo6e7"esfeQ'fl//OR7 specifies the instance of 
the MORTto be tested. If the parameter is 
absent, the MORT\s identical to the object 
instance to which the subject operation is 
directed to. 

The parameter testerObjectClass specifies 
the class of the associated tester object. 
The parameter 

testerObjectlnitialAttributeList carries some 
or all the values of the attributes of the TO 
instance responsible for the test. The 
syntax and semantics of this attribute 
value is dependent on the specific TO 
class definition and is outside the scope of 
3GPP. 



6.3.1.3 



Output parameters 



Parameter Name 


Qualifier 


Matching Information 


Comment 


response 


M 


Resource self test: 


The number and the order, related to the tests to be 






SEOUENCE OF CHOICE { 


initiated, of elements in this sequence and in the set of 






testlnitiated 


the input parameter toBelnitiatedTests shall be identical. 






testNotlnitiated 


For a successfully instantiated test the parameter 






} 


testlnitiated returns the test invocation identifier of the 






testlnitiated = 


test. For a failed test instantiation the parameter 






Testlnvocation.testlnvocationid 


testNotlnvoked returns the reason why the instantiation 






testNotlnitiated = 


of the test failed. 






failureReason 


Failure reasons are 
TO class is not existing 
IVIORT is not existing 
MORT is not available 
others 
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6.3.1.4 Pre-condition 

The precondition must hold true before the operation is invoked. The pre-condition depends on the test category. 
Resource Self Test: 

For at least one of the specified tests to be instantiated the following must hold true: 
thelndicatedMORTIsExisting AND thelndicatedMORTIsAvailable AND thelndicatedTOClassIsExisting. 



Assertion Name 


Definition 


thelndicatedMORTIsExisting 


The IVIORT indicated by the subject operation for this test is existing 


thelndicatedlVIORTIsAvailable 


The IVIORT indicated by the subject operation for this test is available. 


thelndicatedTOClassIsExisting 


The TO class indicated by the subject operation for this test is existing. 



6.3.1.5 Post-condition 

The post-condition must hold true after the completion of the operation: 
alllndicatedTOsInstantiated OR notAllTestsInitiated OR noTestlnitiated 



Assertion Name 


Definition 


allTestslnitiated 


All tests indicated by the subject operation were initiated successfully. 


notAllTestsInitiated 


Not all but at least one test indicated by the subject operation was initiated 
successfully. 


noTestlnitiated 


No test indicated by the subject operation was initiated successfully. 



6.3.1.6 



Exceptions 



Exception Name 


Definition 


operationFailedEntirely 


Condition: noTestlnitiated = TRUE 

Returned information: The response parameter is returned 

Exit state: Entry state 


opeartionFailedPartly 


Condition: notAllTestsInitiated = TRUE 

Returned information: The response parameter is returned 

Exit state: Entry state 



6.3.2 Operation terminateTests (M) 



6.3.2.1 



Definition 



The IRPManager uses this operation to request the IRP Agent to terminate tests during their life time. A single 
terminateTests operation may terminate multiple (one or more) tests. 

The tests to be terminated are identified by their test invocation identifiers. The IRPManager terminating a test may be 
different from the IRPManager that initiated the test. The terminateTests operation must be invoked on the object which 
received the corresponding initiateTests operation. 



6.3.2.2 



Input parameters 



Parameter Name 


Qualifier 


Information Type 


Comment 


to BeTerm i natedTests 


M 


SET OF Testlnvocation.testlnvocationid 


This parameter specifies the tests that shall 
be terminated. 
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6.3.2.3 



Output parameters 



Parameter Name 


Qualifier 


IVIatching Information 


Comment 


response 


M 


SEQUENCE OF CHOICE! 


The number and tlie order, related to the test 






testTerminated 


invocation identifier, of elements in this sequence 






testNotTerminated 


and in the set of the input parameter 






} 


toBeTerminatedTests s'naW be identical. 






testTerminated = 


It specifies the test invocation ids of the tests, that 






Testlnvocation.testlnvocationid 


were successfully terminated, and the ids of the 






testNotTerminated = 


tests, that failed to be terminated successfully 






SEQUENCE { 


together with the reason for the failure. 






Testlnvocation.testlnvocationid, 


Failure reasons are 






failureReason 


test invocation id is not existing 






} 


others 



6.3.2.4 Pre-condition 

The precondition must hold true before the operation is invoked. 

alllndicatedTestlnvocationldsAreExisting ORnotAllIndicatedTestlnvocationldsAreExisting 



Assertion Name 


Definition 


alllndicatedTestlnvocationldsAreExisting 


All test invocation identifiers specified by the subject operation are 
existing. 


notAlllndicatedTestlnvocationldsAreExisting 


Not all but at least one test invocation identifier specified by the subject 
operation is existing. 



6.3.2.5 Post-condition 

The post-condition must hold true after the completion of the operation. 

alllndicatedTestsTerminated OR notAllIndicatedTestsTerminated OR noIndicatedTestTerminated 



Assertion Name 


Definition 


alllndicatedTestsTerminated 


All tests indicated in the subject operation were terminated successfully. 


notAllIndicatedTestsTerminated 


Not all but at least one test indicated in the subject operation aaws terminated 
successfully 


noIndicatedTestTerminated 


No test indicated in the subject operation aaws terminated successfully 



6.3.2.6 



Exceptions 



Exception Name 


Definition 


operationFailedEntirely 


Condition: noIndicatedTestTerminated = TRUE 

Returned information: The response parameter is returned 

Exit state: Entry state 


operationFailedPartly 


Condition: notAlllndicatedTestlnvocationldsAreExisting = TRUE OR 
notAllIndicatedTestsTerminated = TRUE 
Returned information: The response parameter is returned 
Exit state: Entry state 



£75/ 



3GPP TS 32.322 version 5.0.1 Release 5 



21 



ETSI TS 132 322 V5.0.1 (2002-12) 



6.4 I nte rf ace TestManagementlRPMonitorOperations 

The interface TestManagementlRPMonitorOperations contains the operation monitorTest. It has a realisation 
relationship with the IOC TestActionPerformer. 

6.4.1 Operation moA?/Yorresf (M) 



6.4.1.1 



Definition 



IRPManager shall be able to retrieve information about the test as observed by the TO during the test execution by 
reading the relevant attributes of the TO associated to the test. Also after the test execution the manager shall be able to 
read these attributes as long as the TO exists. Attributes conveying information about the test execution are testState and 
testOutcome. Depending on the specific test category specific TO or the VSE TO other attributes may also contain 
information about the test execution. In this case the subject operation may also allow to read the values of these 
attributes. 



6.4.1.2 



Input parameters 



Parameter Name 


Qualifier 


Information Type 


Comment 


toBeMonitoredTO 


M 


tOlnstance 


This parameter specifies the instance of the 
tester object, whose attribute values of 
testState, testOutcome and other attributes 
shall be retrieved. 


toBeMonitoredAttributes 


M 


SET OF attributeldentifier 


This parameter specifies the identifiers of 
the attributes whose values shall be read. 



6.4.1.3 



Output parameters 



Parameter Name 


Qualifier 


Matching Information 


Comment 


monitoredAttributeValues 


M 


SET{ 

TesterObject.testState (M) 
TesterObject.testOutcome (IVI) 
other attributes (0) 

} 


This parameter shall be returned if all attributes 
were read successfully and may be returned, if 
at least one attribute was read successfully. 
The values to be returned are those prevalent 
at the time of the reception of the subject 
operation. 


error 


M 


failureReason 


This parameter shall be returned if the 

specified tester object instance is not existing 

or, in case the tester object instance is existing, 

at least one attribute could not be read, i. e. if 

operationFailedEntirely = TRUE 

OR 

operationFailedPartly = TRUE 

The parameter returns the failure reason. 



6.4.1.4 Pre-condition 

The precondition must hold true before the operation is invoked. 
indicatedTOInstancelsExisting 



Assertion Name 


Definition 


toBeMonitoredTOIsExisting 


The TO instance indicated by the subject operation is existing. 
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6.4.1.5 Post-condition 

The post-condition must hold true after the completion of the operation. 

allAttributeValuesRead OR notAUAttributeValuesRead OR noAttributeValueRead 



Assertion Name 


Definition 


allAttributeValuesRead 


All attributes of the TO indicated by the subject operation were read successfully. 


notAUAttributeValuesRead 


Not all but at least one attribute of the TO indicated by the subject operation were 
read successfully. 


noAttributeValueRead 


No attribute of the TO indicated by the subject operation was read successfully. 



6.4.1.6 Exception 



Exception Name 


Definition 


operationFailedEntirely 


Condition: toBeMonitoredTOIsExisting = FALSE OR noAttributeValueRead = 

TRUE 

Returned information: The error parameter returns the object identifier of the TO 

that does not exist or the reasons, why the attributes could not be read 

Exit state: Entry state 


operationFailedPartly 


Condition: toBeMonitoredTOIsExisting = TRUE AND notAUAttributeValuesRead 

= TRUE 

Returned information: The error parameter returns the reason why an attribute 

could not be read. The attribute that could be read my be returned in the 

parameter error ox the parameter attributeList 

Exit state: Entry state 



6.5 I nte rf ace TestManagementlRPNotifications 
6.5.1 Notification notifyTestResults (M) 



6.5.1.1 



Definition 



Test results are made available to the IRPManager by one or more notifications notifyTestResults emitted by the TO that 
is related to the test invocation. 

Depending on the nature of the test and the specification of the TO behaviour, the TO may need to convey to the 
IRPManager a test result data set. There are two ways to convey this kind of information. One way is to use the 
parameter additionallnformation of the notification. In this case, the fileReference and fileExpiryDate shall contain no 
information or be absent. The other way is to use a file to capture the test result data set. In this case, the 
additionallnformation parameter may contain no information or be absent and the fileRefe rence and fileExpiryDate 
shall be present. The file that captures the test result data set shall contain VSE attributes and other 3GPP attributes such 
as testerObjectClass, testOutcome, etc. 

The use of the additionallnformation parameter or a file to capture the test result data set is specified by the class 
specification of the TO. 

In case the TO uses additionallnformation (and not a file) to capture the test result data set, that TO may emit this 
notification to transfer intermediate (non-final) test results. In this kind of notifications, the testOutcome parameter shall 
be absent. The TO should emit at least one more notification regarding the subject test invocation in the future. The last 
notification pertaining to a particular test invocation shall be indicated by including the testOutcome parameter in the 
notification. 

In the case the TO uses a file to capture the test result data set, that TO shall not issue any notifications to transfer 
intermediate test results. The TO may capture the non-final test results in the file used to capture the final test result data 
set. 

The events triggering the emission of test result notifications depend on the specific test. They shall be specified by the 
TO that is actually instantiated, i.e. either by the test category specific TO or the VSE TO. Some generic triggering 
events are included in this specification. It is expected that vendors specify more triggering events. 
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Parameter Name 


Qualifier 


IVIatching Information 


Comment 


objectClass 


M, F 


TesterObject.testerObjectClass 


This parameter is specified by 
NotificationlRPNotification defined in 3GPP TS 
32.302 [1]. It specifies the class of the TO 
emitting the subject notification. 


objectlnstance 


M, F 


TesterObject.testerObjectId 


This parameter is specified by 
NotificationlRPNotification defined in 3GPP TS 
32.302 [1]. It specifies the instance of the TO 
emitting the subject notification. 


notificationid 







This parameter is specified by 
NotificationlRPNotification defined in 3GPP TS 
32.302 [1]. It carries the semantics of the 
notification identifier. 


eventTime 


M, F 




This parameter is specified by 
NotificationlRPNotification defined in 3GPP TS 
32.302 [1]. It carries the time when the subject 
notification is emitted. 


systemDN 


C, F 


IRPAgent.systemDN 


This parameter is specified by 
NotificationlRPNotification defined in 3GPP TS 
32.302 [1]. It carries the systemDN oi the 
IRPAgent related to the TestManagementlRP. 


notificationType 


M, F 


"notifyTestResults" 


This parameter is specified by 
NotificationlRPNotification defined in 3GPP TS 
32.302 [1] 


testlnvocationid 





Testlnvocation.testlnvocationid 




testlnvocationlnitiator 


C, F 


TesterObject.testlnvocationlnitiator 




testOutcome 



see note 


TesterObject.testOutcome 


This parameter shall be included only in the 
last notification emitted by a TO. In this way 
the TO indicates that it is sending no more 
notifications. 


mORT 





TesterObject.theMORT 


This parameter identifies the object instance of 
the IVIORT that was subject to the test. 


proposedRepairActions 





TesterObject.proposedRepairActions 




additionallnformation 



see note 


TesterObject.additionallnformation 


This parameter allows the inclusion of any 
additional information in the notification. As 
such, it may carry a test result data set. 
The exact semantics of this parameter is 
outside the scope of this specification. 
This parameter may contain no information or 
be absent, if the test results are captured in a 
file. It may be present if the test results are not 
captured in a file. 


fileReference 


M 
see note 


TesterObject.fileReference 


This parameter shall contain no information or 
be absent if there is no test result captured in a 
file. It shall contain information if the test 
results are captured in a file. 


fileExpiryDate 


M 
see note 


TesterObject.fileExpiryDate 


This parameter shall contain no information or 
be absent if fileReference carries no 
information or absent. Otherwise, it shall 
contain a valid future date and time. 


NOTE: As for the correct interpretation of tliis qualifier refer to the comment column. 



6.5.1.2 



Triggering Events for the Resource Self Test 



For the resource self test the events triggering the emisson of test result notifications are: 

• Termination of the test execution. 

The resource self test may be terminated explicitly by a test termination request. The events triggering an implicit 
termination are: 

• Fulfillment of the conditions for a successful termination of the test. 

• Fulfillment of the conditions for a premature termination of the test. 

• Occurance of an error situation. 
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6.5.1.2.1 



From-State 



testTerminateRequestReceived OR testCompleted OR prematureTermination OR testTimedOut OR 
errorSituationOccured. 



Assertion Name 


Definition 


testTerminateRequest 
Received 


The object with the ability to receive and react upon test requests has received a test termination 
request (see note). 


testCompleted 


The predefined conditions for a successful completion of the test are fulfilled (see note). 


prematureTermination 


The predefined conditions for a premature termination of the test are fulfilled (see note). 


errorSituationOccured 


An error situation has occurred during the test execution and the tester object has aborted the test 
invocation (see note). 


NOTE: The conditions to satisfy this trigger are related to the VSE TO definition and therefore, their specifications are 
outside the scope of 3GPP. 



6.5.1.2.2 
testTerminated 



To-State 



Assertion Name 


Definition 


testTerminated 


The test has been terminated successfully. 
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